home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 2.iso / dist / fw_groff.idb / usr / freeware / catman / u_man / cat1 / grotty.Z / grotty
Text File  |  2002-04-08  |  6KB  |  132 lines
  1. GROTTY(1)                        GROTTY(1)
  2.  
  3.  
  4.  
  5. NNAAMMEE
  6.        grotty -    groff driver for typewriter-like devices
  7.  
  8. SSYYNNOOPPSSIISS
  9.        ggrroottttyy [    --hhffbbuuooddBBUUvv ] [ --FF_d_i_r ] [ _f_i_l_e_s...  ]
  10.  
  11.        It  is  possible     to have whitespace between the    --FF option
  12.        and its parameter.
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.        ggrroottttyy translates the output of    GNU  ttrrooffff  into  a  form
  16.        suitable     for  typewriter-like  devices.      Normally ggrroottttyy
  17.        should be invoked  by  using  the  ggrrooffff     command  with    a
  18.        --TTaasscciiii,    --TTllaattiinn11 or --TTuuttff88 option on ASCII based systems,
  19.        and with    --TTccpp11004477 on EBCDIC based hosts.     If no files  are
  20.        given, ggrroottttyy will read the standard input.  A filename of
  21.        -- will also cause ggrroottttyy    to read    the standard input.  Out
  22.        put is written to the standard output.
  23.  
  24.        Normally     ggrroottttyy     prints     a  bold  character  _c    using the
  25.        sequence    `_c BACKSPACE _c'    and a italic character _c  by  the
  26.        sequence     `__  BACKSPACE    _c'.   These sequences can be dis
  27.        played on a terminal by piping through uull(1).  Pagers such
  28.        as  mmoorree(1)  or    lleessss(1)     are  also  able to display these
  29.        sequences.  Use either --BB or --UU when piping into     lleessss(1);
  30.        use --bb when piping into mmoorree(1).     There is no need to fil
  31.        ter the output through ccooll(1) since ggrroottttyy  never  outputs
  32.        reverse line feeds.
  33.  
  34.        The font    description file may contain a command
  35.  
  36.           iinntteerrnnaallnnaammee _n
  37.  
  38.        where  _n    is a decimal integer.  If the 01 bit in    _n is set,
  39.        then the    font will be treated as    an italic font;    if the 02
  40.        bit  is    set, then it will be treated as    a bold font.  The
  41.        code field in the font description field     gives    the  code
  42.        which will be used to output the    character.  This code can
  43.        also be used in the \\NN escape sequence in ttrrooffff.
  44.  
  45. OOPPTTIIOONNSS
  46.        --FF_d_i_r  Prepend directory    _d_i_r//ddeevv_n_a_m_e to    the  search  path
  47.           for  font    and device description files; _n_a_m_e is the
  48.           name of the device, usually aasscciiii, llaattiinn11, uuttff88, or
  49.           ccpp11004477.
  50.  
  51.        --hh     Use  horizontal  tabs  in     the  output.    Tabs  are
  52.           assumed to be set    every 8    columns.
  53.  
  54.        --ff     Use form feeds in    the output.  A form feed will  be
  55.           output  at  the end of each page that has    no output
  56.           on its last line.
  57.  
  58.        --bb     Suppress the use of overstriking for  bold  charac
  59.           ters.
  60.  
  61.        --uu     Suppress    the use    of underlining for italic charac
  62.           ters.
  63.  
  64.        --BB     Use only overstriking for    bold-italic characters.
  65.  
  66.        --UU     Use only underlining for bold-italic characters.
  67.  
  68.        --oo     Suppress    overstriking  (other  than  for     bold  or
  69.           underlined characters).
  70.  
  71.        --dd     Ignore  all  \\DD commands.     Without this ggrroottttyy will
  72.           render \\DD''ll......''  commands    that  have  at    least  at
  73.           least one    zero argument (and so are either horizon
  74.           tal or vertical) using --,    || and ++    characters.
  75.  
  76.        --vv     Print the    version    number.
  77.  
  78. FFIILLEESS
  79.        //uussrr//ffrreeeewwaarree//sshhaarree//ggrrooffff//11..1177..22//ffoonntt//ddeevvaasscciiii//DDEESSCC
  80.           Device description file for aasscciiii    device.
  81.  
  82.        //uussrr//ffrreeeewwaarree//sshhaarree//ggrrooffff//11..1177..22//ffoonntt//ddeevvaasscciiii//_F
  83.           Font description file for    font _F of aasscciiii    device.
  84.  
  85.        //uussrr//ffrreeeewwaarree//sshhaarree//ggrrooffff//11..1177..22//ffoonntt//ddeevvllaattiinn11//DDEESSCC
  86.           Device description file for llaattiinn11 device.
  87.  
  88.        //uussrr//ffrreeeewwaarree//sshhaarree//ggrrooffff//11..1177..22//ffoonntt//ddeevvllaattiinn11//_F
  89.           Font description file for    font _F of llaattiinn11  device.
  90.  
  91.        //uussrr//ffrreeeewwaarree//sshhaarree//ggrrooffff//11..1177..22//ffoonntt//ddeevvuuttff88//DDEESSCC
  92.           Device description file for uuttff88 device.
  93.  
  94.        //uussrr//ffrreeeewwaarree//sshhaarree//ggrrooffff//11..1177..22//ffoonntt//ddeevvuuttff88//_F
  95.           Font description file for    font _F of uuttff88 device.
  96.  
  97.        //uussrr//ffrreeeewwaarree//sshhaarree//ggrrooffff//11..1177..22//ffoonntt//ddeevvccpp11004477//DDEESSCC
  98.           Device description file for ccpp11004477 device.
  99.  
  100.        //uussrr//ffrreeeewwaarree//sshhaarree//ggrrooffff//11..1177..22//ffoonntt//ddeevvccpp11004477//_F
  101.           Font  description    file for font _F    of ccpp11004477 device.
  102.  
  103.        //uussrr//ffrreeeewwaarree//sshhaarree//ggrrooffff//11..1177..22//ttmmaacc//ttttyy..ttmmaacc
  104.           Macros for use with ggrroottttyy.
  105.  
  106.        //uussrr//ffrreeeewwaarree//sshhaarree//ggrrooffff//11..1177..22//ttmmaacc//ttttyy--cchhaarr..ttmmaacc
  107.           Additional klugdey character  definitions     for  use
  108.           with ggrroottttyy.
  109.  
  110.        Note  that  on  EBCDIC  hosts,  only  files for the ccpp11004477
  111.        device will be installed.
  112.  
  113. BBUUGGSS
  114.        ggrroottttyy is intended only for simple documents.
  115.  
  116.        There is    no support for fractional horizontal or     vertical
  117.        motions.
  118.  
  119.        There  is no support for    \\DD commands other than horizontal
  120.        and vertical lines.
  121.  
  122.        Characters above    the first line (ie with    a vertical  posi
  123.        tion of 0) cannot be printed.
  124.  
  125. SSEEEE AALLSSOO
  126.        ggrrooffff(1),     ttrrooffff(1),      ggrrooffff__oouutt(5),       ggrrooffff__ffoonntt(5),
  127.        ggrrooffff__cchhaarr(7), uull(1), mmoorree(1), lleessss(1)
  128.  
  129.  
  130.  
  131. Groff Version 1.17.2       27 June 2001            GROTTY(1)
  132.